镜像构建

Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.

SDK下载与编译

支持型号

  • QSM565DP-WF

下载SDK

您可以通过以下两种方式获取Quectel Pi H1的Linux SDK：

方式一：从官方网站下载

请访问 Quectel开发者中心资源下载页面 下载Quectel Pi H1 SDK编译资源包。

在资源下载页面，选择 Quectel Pi 产品类型，然后选择 固件 类型，找到对应的 Quectel Pi H1 SDK编译资源包 进行下载：

../../../_images/image_WUEvbE1pjoDDimxKgNOc9jfVnmg.webp

下载的SDK包包含：

  • 预编译固件：可直接用于烧录的镜像文件

  • 编译工具链（可选）：如需自定义开发，可进行二次编译

方式二：从GitHub克隆

您也可以直接从GitHub仓库克隆SDK源码：

git clone https://github.com/Quectel-Pi/Pi-H1-Linux-SDK.git

克隆完成后，进入 Pi-H1-Linux-SDK 目录即可开始使用。

快速使用
如果您只需要使用官方固件进行烧录，可以跳过下面的编译步骤，直接跳转到 获取镜像 章节，解压SDK包后即可获得所有烧录所需的镜像文件。

自定义编译（可选）

注意：以下章节适用于需要修改源码或自定义配置的开发者。如果您只是使用官方固件，可以跳过此部分。

构建环境

代码下载成功后，进入*Pi-H1-Linux-SDK*主目录下，首先执行:

source quectel_build/compile/build.sh

执行此命令后，终端会自动切换到 build-qcom-wayland 目录，这是正常现象。后续的 buildconfig 和 buildall 命令都将在此目录下执行。

步骤一： 执行如下命令构建环境：

buildconfig QSM565DWF QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X STD

您可以根据提示输入用户定制的 project_name project_rev custom_name，从提示的 Valid Projects 和 Valid CUST_NAME 里面选择当前有效的字段进行用户定制。

配置成功后，您会看到当前的构建配置信息：

MACHINE    = qcm6490-idp
DISTRO     = qcom-wayland
BUILDTYPE  = default
BSP-TYPE   = qcom-custom-bsp

以及确认的项目配置：

Current QUECTEL_PROJECT_NAME = QSM565DWF
Current QUECTEL_PROJECT_REV  = QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
Current QUECTEL_CUSTOM_NAME  = STD

AP侧整编

步骤二： 执行如下命令在AP侧进行整编：

buildall

此过程大概需要运行 1~2小时。
编译过程中：
出现 When reparsing 的错误请不用在意，不影响编译结果。

ERROR: When reparsing .....
ERROR: The following commands may help:

直到出现 all succeeded 表示编译成功。

NOTE: Tasks Summary: Attempted 15639 tasks of which 3 didn't need to be rerun and all succeeded.

一键打包

步骤三： 执行如下命令进行一键打包：

buildpackage

此过程会将编译好的镜像文件打包到指定目录，整个过程大约需要 10~20秒。

打包过程中会显示：

Process QSM565DWF type items
TARGET_DIR: /home/kane/Pi-H1-Linux-SDK/quectel_build/QSM565DWFPIARL1A01_BL01BP01K0M01_QDP_LP6.6.0XX.01.00X_V0X
===============copy image begin==============

当看到以下信息时，表示打包成功：

copy ap version successful
copy bootbinaries to TARGET_DIR successful
copy prog_firehose to TARGET_DIR successful
copy partition to TARGET_DIR successful
===============Build version success and build_time:0m13s===============

打包完成后，所有烧录所需的镜像文件都会被复制到目标目录。

获取镜像

根据您的使用场景，有两种方式获取镜像文件：

方式一：直接使用官方固件（推荐）

将从 Quectel开发者中心 下载的固件包进行解压，即可在解压目录中找到所有烧录所需的镜像文件。

../../../_images/image_AFpmb58cDomc8vxgdfRczc8FnJg.webp

方式二：自定义编译后获取

如果您完成了上述自定义编译步骤，编译后的镜像位于：workspace/quectel_build/项目版本号

镜像文件说明

镜像目录中包含以下主要文件：

引导加载程序相关：

  • xbl.elf -主引导加载程序

  • xbl_config.elf - XBL配置文件

  • uefi.elf - UEFI固件

系统镜像：

  • system.img -系统镜像文件（主要镜像）

  • dtb.bin -设备树二进制文件

  • vmlinux - Linux内核

  • kernel-modules.tgz -内核模块

烧录配置文件：

  • rawprogram*.xml -原始编程配置文件

  • patch*.xml -补丁配置文件

  • gpt_main*.bin / gpt_backup*.bin - GPT分区表

其他固件：

  • aop.mbn - Always-On Processor固件

  • tz.mbn - TrustZone固件

  • cpucp.elf - CPU控制处理器固件

  • prog_firehose - Firehose烧录工具